home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / FEOF.HDR < prev    next >
Text File  |  1994-04-25  |  927b  |  42 lines

  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _FEOF( nHandle ) --> lEOFStatus
  8.  
  9. PARAMETERS:
  10.  
  11. nHandle : handle of previously opened file
  12.  
  13. SHORT:
  14.  
  15. Check for end of file reached.
  16.  
  17. DESCRIPTION:
  18.  
  19. _FEOF() is used in conjunction with _ReadLine() to test for End-Of-File.  It
  20. returns TRUE when the file pointer is at EOF.
  21.  
  22. NOTE:
  23.  
  24.  
  25.  
  26. EXAMPLE:
  27.  
  28. #include "fileio.ch"
  29. handle = fopen('INPUT.TXT,FO_READ)
  30.  
  31. while !_FEOF(handle)
  32.     This_Line = _ReadLine(handle)
  33.     ? This_Line
  34. end
  35.  
  36.  
  37. Result:  Each line of the text file is read into the This_Line variable
  38. and displayed until all lines have been read and _FEOF() then returns TRUE,
  39. exiting the loop.
  40.  
  41. ******************************************************************************/
  42.